Редактирование департамента

Запрос позволяет редактировать департамент.

Синтаксис запроса

PUT https://b2b-api.go.yandex.ru/integration/2.0/departments/update?department_id={идентификатор департамента}

Заголовки запроса

• Authorization: Bearer <OAuth-токен>
  Процесс получения токена описан в разделе Начало работы.

• X-YaTaxi-Selected-Corp-Client-Id — ID клиента из Личного кабинета. Обязателен, если по токену доступно несколько клиентов.

Параметры запроса

Запрос содержит обязательный параметр:

• department_id — идентификатор департамента, по которому обновляется информация.

Тело запроса

Данные о департаменте передаются в теле запроса в формате JSON:

Изменяются только те поля, для которых переданы соответствующие параметры в теле запроса. Например, можно поменять только название, при этом parent_id можно не передавать.

Пример запроса

PUT https://b2b-api.go.yandex.ru/integration/2.0/departments/update?department_id=87e8...f646c
...
Authorization: Bearer <OAuth-token>
X-YaTaxi-Selected-Corp-Client-Id: <client-id>

    { 
        "parent_id": "63e8...5d8c",
        "name": "Маркетинг B2B"
    }

Пример ответа

В случае успешного запроса будет возвращен пустой ответ с кодом 200.

Возможные коды ответа

Ответ на данный запрос может содержать следующие стандартные HTTP-коды:

• 200 — запрос выполнен успешно.
• 400 — в запросе был передан неизвестный параметр или параметр с недопустимым значением.
• 401 — был передан неверный OAuth-токен.
• 403 — у клиента не хватает прав на выполнение данного запроса.
  • SELECT_CLIENT_HEADER_REQUIRED: в запросе не передан заголовок X-YaTaxi-Selected-Corp-Client-Id (возвращается в случае, если для токена доступно более одного клиента).
  • SELECTED_CLIENT_ACCESS_DENIED: в заголовке X-YaTaxi-Selected-Corp-Client-Id передан ID клиента, к которому нет доступа у этого логина.
• 406 — запись с указанными параметрами уже существует.
• 409 — циклическая иерархия.